home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 19 / CU Amiga Magazine's Super CD-ROM 19 (1998)(EMAP Images)(GB)[!][issue 1998-02].iso / OpenBSD / untgz.readme < prev    next >
Text File  |  1997-03-02  |  5KB  |  157 lines
  1. Short: Small and efficient tar.gz unarchiver
  2. Uploader: owagner@vapor.com (Oliver Wagner)
  3. Author: owagner@vapor.com (Oliver Wagner)
  4. Type: util/arc
  5. Version: 1.5
  6. Kurz: Kurzer und effizienter tar.gz-Extrahierer
  7.  
  8. Long:
  9.  
  10. UnTGZ 1.5
  11. =========
  12.  
  13. Introduction
  14. ------------
  15.  
  16. UnTGZ is a extractor/list for the combined tar/gzip archive format which is
  17. esspecially popular in the unix world.  Actually, a tar.gz (or .tgz)
  18. archive is a collection of files which have been archived with the tar
  19. (tape archive) program, which's output in turn has been compressed using
  20. the gzip packer.  
  21.  
  22. The major advantage of this procedure is that all the files in the archive
  23. are compressed in a single block, instead of single files.  Due to the
  24. nature of the used compression techniques which try to find duplicate
  25. "strings" in the data this yields much better compression ratios
  26. as if all the files would be compressed one by one, because the
  27. search for duplicate data can span several of the source files.
  28.  
  29. As a result, a tar.gz archive in average gives much better compression
  30. ratio than the LHA format which is currently in use in the Amiga
  31. world. The now out-of-development LZX archiver used a similiar
  32. technique, and therefore the tar.gz combination gives similiar
  33. compression ratios than the LZX format.
  34.  
  35. However, the tar.gz format is not in wide use in the Amiga community
  36. because many people find the usage of two programs which have a very
  37. "unixish" syntax just to extract a single archive a bit stressing.
  38.  
  39. UnTGZ, however, is a single, compact program which's sole purpose
  40. is to list and extract tar.gz archives with a mode of operation
  41. similiar to existant archive utilities.
  42.  
  43. Advantages
  44. ----------
  45.  
  46. - UnTGZ is heavily optimized for speed and memory usage.
  47.   Memory requirement for a decompression run is about 80k.
  48.  
  49. - UnTGZ itself is very compact (currently 13k), thus
  50.   saving space on distribution disks. It can be made
  51.   resident.
  52.  
  53. - UnTGZ has been designed in a way that the "look & feel"
  54.   of existant archive utilities like LHA or LZX is
  55.   preserved.
  56.  
  57. - UnTGZ works with AmigaOS 1.2/1.3 machines. No special
  58.   libraries
  59.  
  60. - UnTGZ can be used as a default tool from Workbench
  61.   Project Icons to easily provide "Click&Extract" functionality.
  62.   WB Operation can be customized via icon tooltypes.
  63.   Actions are displayed via standard console windows
  64.   (it will automatically recognize an installed KingCon Handler
  65.   and use a KCON: window for scrollback and appicon support)
  66.  
  67.  
  68. Shell-Usage
  69. -----------
  70.  
  71. Shell usage is very straightforward:
  72.  
  73.  UnTGZ [-v] archivename [destination directory]
  74.  
  75. "-v" specifies that the archive is to be listed, not extracted.
  76. UnTGZ also recognizes "-l", "v" and "l" as synonyms for that.
  77.  
  78. "destination directory" optionally specifies the, you guessed it,
  79. destination directory where the files are to be extracted into.  This
  80. defaults to the current directory as to the time of invocation.
  81.  
  82. Note that UnTGZ automatically tries to locate archive files
  83. by appending ".tar.gz" and ".tgz" to the archivename if
  84. no extension is given.
  85.  
  86. Workbench usage
  87. ---------------
  88.  
  89. In order to use UnTGZ from the Workbench, you have to create
  90. project icons for the ".tar.gz" files, which's default tool
  91. points to the UnTGZ executable.
  92.  
  93. You can specify tooltypes in this project icons to customize
  94. UnTGZ's behavior:
  95.  
  96.  Window=con:blabla
  97.  Define the console window used for output and queries.
  98.  Defaults to "CON:0/0/640/400/UnTGZ" for OS 1.2/1.3
  99.  and to "[K]CON:0/0/640/400/UnTGZ/WAIT/CLOSE" for OS2+
  100.  environments.
  101.  
  102.  Destination=Path
  103.  Define destination path. Defaults to "RAM:". This
  104.  can be modified by the user, unless "ForceExtract"
  105.  is specified.
  106.  
  107.  ForceView
  108.  Force display of archive contents, not asking the
  109.  user for actions.
  110.  
  111.  ForceExtract
  112.  Force extraction of files, not asking the user for
  113.  actions.
  114.  
  115.  Message=Text...
  116.  Output this text before asking the user for actions.
  117.  Defaults to no text.
  118.  
  119. You should specify a stack size of 20480 in the project
  120. icon to avoid having UnTGZ allocate it's own stack,
  121. thus saving a few k of memory.
  122.  
  123.  
  124. History
  125. -------
  126.  
  127. 1.5 - fixed problem that under certain circumstances
  128.       the last file written to remains open
  129.  
  130. 1.4 - recompiled with SAS/C 6.57
  131.     - modified behavior as a Workbench tool: Clicking
  132.       on the close gadget of the CON: window will
  133.       silently quit the program, instead of
  134.       starting the unpack process.
  135.  
  136. 1.3 - First release version
  137.  
  138.  
  139. Copyright
  140. ---------
  141.  
  142. UnTGZ was written by Oliver Wagner <owagner@vapor.com>.
  143.  
  144. The "inflate" decompression code used inside the program was written and
  145. placed in the public domain by Mark Adler.
  146.  
  147. UnTGZ 1.5 may be freely distributed. Commercial usage of any kind
  148. requires prior permission.
  149.  
  150. No warranties of any kind, use on your own risk, don't put in
  151. child's hands etc. You can be assured it won't ObtainSemaphore()
  152. your screen's Layer on input.device schedule, though :-)
  153.  
  154. EMail bug reports and related stuff to <owagner@vapor.com>.
  155.  
  156. See http://www.vapor.com/ for other neat stuff.
  157.